home *** CD-ROM | disk | FTP | other *** search
/ Aminet 4 / Aminet 4 - November 1994.iso / aminet / comm / uucp / wcnews_1_0_30.readme < prev    next >
Text File  |  1994-10-08  |  15KB  |  274 lines
  1. Short:    Wusel's CNews (UUCP news system)
  2. Author:   Kai 'wusel' Siering <wusel@hactar.hanse.de>
  3. Uploader: Christian Stelter <cosinus@deepthought.north.de>
  4. Type:     comm/uucp
  5.  
  6. This is wCNews 1.0.30 - a very nice news system which didn't make
  7. its way to the aminet. (I can't imagine why...)
  8.  
  9. Some notes from the author:
  10.  
  11.      this stuff  is a modified (and partialy enhanced =:->) version of
  12. CNews,   based   on   the   port   done   by   Frank  'Crash'  Edwards
  13. (uunet-version, *not* the buggy one from teh AmigaLigDisks).
  14.  
  15.      It's primary   intended   to   replace  `Amiga  UUCP  Plus  1.02'
  16. installations  -  it has been modified to comform to the `usual' Amiga
  17. UUCP  directory  layout used by Matt Dillon and Ingo Feulner (that is:
  18. controlfiles  like  `sys',  `active'  or  `history'  in `uulib:news/',
  19. articles  in  `uunews:',  binaries  in  the  AmigaDOS'  search path or
  20. `uulib:news/bin')  and  is  expected  to be run on top of Matt Dillons
  21. UUCP  implementation  (at  least  in  terms  of configuration).  Thus,
  22. former  CNews users will have to reorganize a bit in order to make use
  23. out of this ...
  24.  
  25.      This version  *requires*  at  least  OS  Version  36 and has been
  26. tested  only  on  V37.175  (official  2.0 ROMs) until now. I assume in
  27. cases  where  this  matters,  I've  checked  for the OS version, but I
  28. don't  make  any  guarantees. But as most programs wouldn't run anyway
  29. if  you're  working  with  ancient  OS  versions, I think this doesn't
  30. matter - you have been warned =:->
  31.  
  32.      In the  following,  I  refer  to  `Amiga  UUCP Plus 1.02' by Ingo
  33. Feulner  as  `AUUCP',  to  `Amiga  UUCP'  by Matthew Dillon as `DUUCP'
  34. (optionally  followed  by a version number, e. g. `DUUCP 1.16') and to
  35. the  CNews-Port  done by Frank `crash' Edwards as `CNews'. I call this
  36. stuff myself `wCNews' - no comments, please =:->
  37.  
  38.                      Differences CNews <-> wCNews
  39.  o Configuration
  40.    Above  all,  the  environment  (local,  then  global) is respected.
  41.    After   environment   lookup   failed,   a   lookup  in  the  DUUCP
  42.    configuration  file  (`S:UUConfig' or `UULIB:Config') is performed.
  43.    Finally,  the  old  style CNews configuration stuff is executed, i.
  44.    e. lookup in `uulib:news/CNews.config'.
  45.  
  46.  o NewsHostName
  47.    `uulib:news/whoami'  still  has  highest  priority.  Next comes the
  48.    `hostname'  environment  variable, then DUUCP's `NodeName' is taken
  49.    (if  `DomainPath'  is set to `y[es]', `DomainName' will be appended
  50.    to   the   `NodeName'  value).  If  all  fails,  your  newsname  is
  51.    `anonymous'.
  52.  
  53.  o sys-File
  54.    You  may  specify _exactly_ one `%s' in the sy_cmd field, this will
  55.    be  replaced by an absolute(!) path under which the current article
  56.    has  been  filed.  Of  course,  `<%s'  also works, this way you can
  57.    specify  which  program  should get the article on its stdin (e. g.
  58.    for  `site:grps/dist::lockserial  someprg  <%s'  - a stupid example
  59.    but  you should get the idea =:->) - if you don't specify any `%s',
  60.    in  the  example above, `lockserial' would get the article on stdin
  61.    (same behaviour as under CNews).
  62.    Specifying  a  sys-line  like `s:n/d::dh0:etc/bin/news/format drive
  63.    vd0:  name  %s'  now  also  works  -  before,  at  least my version
  64.    mis-interpreted  `dh0'  as the batchparms and got somewhat upset of
  65.    them.
  66.    Finally:  `site/ex1,ex2,ex3:ng/dist:flgs:'  now  excludes  not only
  67.    `ex1' but - as documented - also `ex2' and `ex3'.
  68.  
  69.  o RFC stuff
  70.    You may set `RFCStrictness' to `0' to `2' to  reject articles  with
  71.    message-ids  not  conforming  to  RFC 822 and unqualified hostnames
  72.    (e. g. `<0851@host>' instead of `<0815@host.do.main>).
  73.  
  74.    RFCStrictness   0    acts like original CNews
  75.    RFCStrictness   1    enables check for `@domain' and illegal chars
  76.    RFCStrictness   2    enables check  for fully  qualified domain as
  77.                         required by RFC 1036 but often ignored.
  78.  
  79.    You  may set `MaxArticleAge' to a decimal value, specifying how old
  80.    an  article  may  be.  Articles  with a `Date:' header specifying a
  81.    date  older  than `MaxArticleAge' days (or with dates more than one
  82.    day in future) will be rejected.
  83.  
  84.    Both  of  the  above  features  are  inspired  by recent UNOX-CNews
  85.    releases  but  implemented as more or less quick and dirty hacks; I
  86.    haven't  had  the  time  to adopt (parts of) the `CNews performance
  87.    release' from May '92 yet ...
  88.  
  89.  o `expire' now checks wheter or not the remove() system call succeeds
  90.    and in case  it fails with  errno != ENOENT,  the article's history
  91.    entry is copied into the new history;  this hopefully  reduces  the
  92.    number of old files left in the news tree ...
  93.  
  94.                                Credits
  95.  
  96.  
  97.      I've incorporated  source  code  and/or  ideas from the following
  98. poeple; thank you for making the source code widely available:
  99.  
  100.               Henry Spencer & Geoff Collyer (UNOX CNews)
  101.               Frank 'crash' Edwards (Amiga port of CNews)
  102.               Ingo Feulner (AUUCP; newscontrol)
  103.               Walter Mildenberger (fixactive, sendbatches)
  104.               Matthew Dillon (configuration, locking and more)
  105.               (apologies if I forgot anyone =:-<)
  106.  
  107.                               Disclaimer
  108.  
  109. See  per-file  copyright  notices;  all my code (most commonly #define
  110. WUSEL)  is  (c)  1991-1992  by Kai `wusel' Siering and may not be used
  111. anywhere  else without my prior written permission. You may not use it
  112. for commercial purposes.
  113.  
  114. This  is  an alpha release for testing purposes, don't blame me if you
  115. loose  anything  due  to  using  this.  I  am  not responsible for any
  116. damages  or losses caused by this software. Standard disclaimers apply
  117. =:->
  118.  
  119.                        Bugreports, Suggestions
  120.  
  121. Please      report      any     bugs     and/or     suggestions     to
  122. <wusel@hactar.hanse.de>.
  123.  
  124.  
  125. ============================= Archive contents =============================
  126.  
  127. Original  Packed Ratio    Date     Time    Name
  128. -------- ------- ----- --------- --------  -------------
  129.    12116    7045 41.8% 04-Jan-94 01:18:50  bin/batcher
  130.    13364    7370 44.8% 04-Jan-94 01:34:50  bin/bdecode
  131.    10740    6597 38.5% 04-Jan-94 01:19:00  bin/bencode
  132.     2637     928 64.8% 07-Aug-93 20:59:38  bin/BugReport
  133.     8476    4551 46.3% 04-Jan-94 01:34:54  bin/c7decode
  134.     5652    3592 36.4% 04-Jan-94 01:19:10  bin/c7encode
  135.      282     201 28.7% 14-Dec-91 23:11:04  bin/comp
  136.      160     129 19.3% 14-Dec-91 23:11:04  bin/compb
  137.      214     161 24.7% 14-Dec-91 23:11:04  bin/compc7
  138.      323     221 31.5% 07-Sep-93 03:06:00  bin/compcun
  139.       76      67 11.8% 31-May-92 23:42:06  bin/compfre
  140. : CNews
  141.      153     130 15.0% 14-Dec-91 23:11:04  bin/compfun
  142.      213     168 21.1% 10-Mar-93 17:36:20  bin/compgun
  143.      191     137 28.2% 21-Apr-93 19:51:10  bin/complzh
  144.       90      80 11.1% 31-May-92 16:28:20  bin/compnone
  145. : CNews
  146.     8416    5203 38.1% 25-Mar-92 16:25:32  bin/ctime
  147.     1180     420 64.4% 06-Jun-93 22:39:40  bin/do.newgroup
  148.      164     119 27.4% 19-Oct-93 02:26:20  bin/doexpire
  149.    61948   32461 47.5% 04-Jan-94 01:36:28  bin/expire
  150.     1997     701 64.8% 07-Aug-93 20:59:38  bin/FeatureRequest
  151.    13532    7984 40.9% 26-Mar-92 02:43:20  bin/FindConfig
  152.    21380   12155 43.1% 04-Jan-94 01:16:12  bin/fixactive
  153.    39948   20346 49.0% 04-Jan-94 01:41:36  bin/gensys
  154.     2304     945 58.9% 19-Dec-93 03:54:44  bin/gensys.autosys
  155.     2322     935 59.7% 19-Dec-93 03:54:34  bin/gensys.changesys
  156.     2058     863 58.0% 19-Dec-93 03:54:26  bin/gensys.maf
  157.    42288   23854 43.5% 25-Mar-93 02:03:36  bin/inews
  158.    16964    9769 42.4% 12-Oct-92 18:35:56  bin/MessageID
  159.    29924   16570 44.6% 04-Jan-94 01:36:36  bin/mkdbm
  160.    11467    2313 79.8% 04-Jan-94 01:08:14  bin/newsdaily
  161.    34716   19191 44.7% 04-Jan-94 01:17:32  bin/newsrun
  162.      107     100  6.5% 14-Dec-91 23:11:04  bin/nocomp
  163.    71024   36261 48.9% 04-Jan-94 01:36:06  bin/relaynews
  164.    28832   15216 47.2% 04-Jan-94 01:34:44  bin/rnews
  165.    21652   11942 44.8% 04-Jan-94 01:19:26  bin/sendbatches
  166.    34716   19191 44.7% 04-Jan-94 01:17:32  bin/unbatch
  167.      189     160 15.3% 14-Dec-91 23:11:04  bin/viamail
  168.      194     149 23.1% 14-Dec-91 23:11:04  bin/viapmail
  169.      134     103 23.1% 14-Dec-91 23:11:04  bin/viarsh
  170.      738     463 37.2% 17-Feb-93 23:11:40  bin/viauux
  171.       95      82 13.6% 31-May-92 23:38:04  bin/viauux_frnews
  172.      763     444 41.8% 10-Mar-93 04:31:24  ChangesSince_Rel24
  173.      133     113 15.0% 18-Mar-93 03:37:48  ChangesSince_Rel25
  174.      285     212 25.6% 20-Mar-93 20:54:04  ChangesSince_Rel26
  175.     1661     809 51.2% 24-Mar-93 14:10:34  ChangesSince_Rel27
  176.     8985    2988 66.7% 31-May-93 05:07:20  ChangesSince_Rel28
  177.     3589    1865 48.0% 09-Dec-93 02:39:40  ChangesSince_Rel29
  178.     9326    4426 52.5% 03-Nov-92 17:57:56  contrib/arbitron/POSTER
  179.     8980    5341 40.5% 06-May-92 19:01:28  contrib/Args
  180.     9656    5810 39.8% 04-Jan-94 01:40:50  contrib/ChangeConfigLine
  181.     7908    4844 38.7% 04-Jan-94 01:41:12  contrib/FixAUUCPHistory
  182.    13084    7638 41.6% 25-Nov-92 06:09:20  contrib/GetLoginAndSite
  183.     6776    3717 45.1% 21-Mar-92 15:31:00  contrib/GetSender
  184.    13540    8004 40.8% 13-Feb-92 00:25:16  contrib/HostName
  185.     6280    3430 45.3% 20-Mar-92 22:09:10  contrib/Ident
  186.    11343    4466 60.6% 22-Oct-92 18:06:38  contrib/joel
  187.     8288    4999 39.6% 13-Feb-92 04:15:00  contrib/Lines
  188.    25572   14458 43.4% 04-Jan-94 01:40:42  contrib/mailgate
  189.    47960   28108 41.3% 29-Sep-92 07:40:14  contrib/newsdaily/egrep
  190.    95080   48295 49.2% 05-Mar-93 21:58:32  contrib/newsdaily/gawk
  191.    33489   11118 66.8% 05-Mar-93 22:01:58  contrib/newsdaily/gawk.man
  192.    47968   28103 41.4% 29-Sep-92 07:40:08  contrib/newsdaily/grep
  193.     7623    2676 64.8% 05-Mar-93 22:01:42  contrib/newsdaily/grep.man
  194.    29228   17003 41.8% 29-Sep-92 07:46:54  contrib/newsdaily/gsort
  195.     7656    2858 62.6% 05-Mar-93 22:01:48  contrib/newsdaily/gsort.man
  196.    49236   22500 54.3% 04-Apr-91 13:35:06  contrib/newsdaily/sed
  197.     7692    2595 66.2% 05-Mar-93 22:01:58  contrib/newsdaily/sed.man
  198.    21908   13047 40.4% 29-Sep-92 07:46:58  contrib/newsdaily/uniq
  199.     3015    1140 62.1% 05-Mar-93 22:01:52  contrib/newsdaily/uniq.man
  200.    44292   24135 45.5% 04-Jan-94 01:40:14  contrib/newsgate
  201.    10244    3893 61.9% 04-Dec-92 03:28:56  contrib/newsgate.man
  202.    15148    8718 42.4% 08-Jul-93 21:59:46  contrib/RebuildHistory/LockFile
  203.     3802    2443 35.7% 30-Mar-93 02:49:46  contrib/RebuildHistory/POSTER
  204.     1384     732 47.1% 09-Jul-93 03:28:56  contrib/RebuildHistory/RebuildHistory
  205.     1986     852 57.0% 08-Jul-93 20:30:54  contrib/RebuildHistory/rh.pass1.rexx
  206.      448     267 40.4% 08-Jul-93 20:26:54  contrib/RebuildHistory/rh.pass2.rexx
  207.     7532    4114 45.3% 21-Mar-92 01:40:30  contrib/SeparateHeaderAndBody
  208.    17020    9944 41.5% 30-Apr-92 16:06:18  contrib/ShortenAddress
  209.     9824    5466 44.3% 25-Feb-91 04:42:08  contrib/StripCR
  210.    13856    8150 41.1% 13-Feb-92 00:30:32  contrib/Username
  211.     4170    1932 53.6% 04-Jan-94 01:19:28  doc/biblio.man
  212.     1141     573 49.7% 15-Dec-90 12:11:52  doc/COPYRIGHT
  213.     3489    1729 50.4% 14-Dec-92 03:15:24  doc/inews.readme
  214.    16590    6963 58.0% 04-Jan-94 01:21:58  doc/install.amiga.man
  215.    14981    6351 57.6% 04-Jan-94 01:21:44  doc/install.man
  216.    19364    7791 59.7% 04-Jan-94 01:20:50  doc/interface.man
  217.      283     112 60.4% 07-Jan-91 15:06:18  doc/PATCHDATES
  218.     4010    1959 51.1% 06-Jun-90 08:36:30  doc/README.amiga
  219.    14728    5842 60.3% 02-Nov-92 01:46:26  doc/README.wusel
  220.     2906    1011 65.2% 14-Jul-93 06:11:20  execute.me
  221.     4219    2141 49.2% 26-Sep-93 02:18:54  KNOWN.PROBLEMS
  222.    15237    3727 75.5% 13-Feb-93 20:23:42  lib/news/active
  223.     1193     375 68.5% 17-Dec-92 23:06:14  lib/news/batchparms
  224.      203     152 25.1% 11-May-93 03:10:40  lib/news/bin/automaps
  225.    10238    2089 79.5% 11-May-93 04:52:22  lib/news/bin/checkgroups
  226.     4101    1369 66.6% 18-Jun-93 01:56:42  lib/news/bin/newgroup
  227.    29272   16089 45.0% 04-Jan-94 01:27:12  lib/news/bin/newscontrol
  228.     1696     630 62.8% 19-Jan-93 03:13:38  lib/news/bin/rmgroup
  229.    17300    9669 44.1% 04-Jan-94 01:15:58  lib/news/bin/unsharmap
  230.     1810     651 64.0% 16-Oct-92 01:48:56  lib/news/bin/version
  231.     3090    1134 63.3% 05-Apr-93 20:46:20  lib/news/bin/wersion
  232.     3546    1432 59.6% 18-Dec-92 01:00:50  lib/news/CNews.config
  233.     1396     385 72.4% 15-Dec-92 16:52:28  lib/news/explist
  234.       54      54  0.0% 13-Feb-93 21:14:30  lib/news/history
  235.       55      43 21.8% 13-Feb-93 21:14:30  lib/news/history.dir
  236.        4       4  0.0% 13-Feb-93 21:14:30  lib/news/history.pag
  237.       38      36  5.2% 06-Jul-91 23:36:38  lib/news/localgroups
  238.     6410    2126 66.8% 12-Apr-93 23:26:02  lib/news/mailpaths
  239.    94462   28102 70.2% 15-Aug-92 08:23:24  lib/news/NewsGroups
  240.     3125    1264 59.5% 13-Feb-93 21:03:06  lib/news/sys
  241.       40      40  0.0% 18-Dec-92 01:08:48  lib/news/whoami
  242.     2430    1006 58.6% 04-Jan-94 01:25:50  man/active.times.man
  243.     1958     866 55.7% 04-Jan-94 01:23:42  man/bencode.man
  244.     1016     489 51.8% 04-Jan-94 01:25:42  man/checknews.man
  245.     6144    2295 62.6% 04-Jan-94 01:26:20  man/dbz.man
  246.    16398    5770 64.8% 04-Jan-94 01:26:36  man/dbz3z.man
  247.    13746    4743 65.4% 04-Jan-94 01:24:34  man/expire.man
  248.     6500    2561 60.6% 04-Jan-94 01:42:24  man/gensys.man
  249.     5358    2049 61.7% 04-Jan-94 01:25:22  man/inews.man
  250.    17489    5800 66.8% 04-Jan-94 01:26:08  man/news.man
  251.     5948    2309 61.1% 04-Jan-94 01:24:20  man/newsaux.man
  252.    12822    4390 65.7% 04-Jan-94 01:25:10  man/newsbatch.man
  253.    11121    3937 64.5% 17-Dec-92 19:10:10  man/newscontrol.man
  254.     2926    1168 60.0% 04-Jan-94 01:24:56  man/newsmail.man
  255.     9145    3212 64.8% 04-Jan-94 01:24:08  man/newsmaint.man
  256.     1776     812 54.2% 04-Jan-94 01:25:32  man/postnews.man
  257.     7797    2768 64.4% 04-Jan-94 01:24:46  man/relaynews.man
  258.     4930    1959 60.2% 04-Jan-94 01:23:54  man/rnews.man
  259.     4176    1842 55.8% 17-Mar-93 13:54:14  man/sendbatches.man
  260.     3717    1646 55.7% 17-Dec-92 18:16:22  man/unsharmap.man
  261.        0       0  0.0% 04-Jan-94 01:33:54  notebook/
  262. : CNews Implementor's Notebook
  263.     6793    3293 51.5% 10-Feb-93 14:25:18  READ.ME
  264.     7112    2272 68.0% 11-May-93 04:52:32  rexx/newsexec.rexx
  265.       14      14  0.0% 04-Jan-94 01:41:46  version.id
  266.     4582    1853 59.5% 04-Jan-94 01:32:12  notebook/bdiffs.man
  267.     8649    3032 64.9% 04-Jan-94 01:32:30  notebook/config.man
  268.     6433    2102 67.3% 04-Jan-94 01:32:42  notebook/ctlfiles.man
  269.     2661    1063 60.0% 04-Jan-94 01:32:54  notebook/ctlmsg.man
  270.     4035    1595 60.4% 04-Jan-94 01:33:06  notebook/dirs.man
  271.      847     388 54.1% 04-Jan-94 01:33:16  notebook/flow.man
  272. -------- ------- ----- --------- --------
  273.  1571210  759603 51.6% 12-Sep-94 17:01:42   140 files
  274.